Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Universal Imaging Messages

GXJobStatus

QuickDraw GX sends the GXJobStatus message to display the current status of a print job during spooling and despooling. You can override the GXJobStatus message to handle status at spooling and despooling times. Your override of the GXJobStatus message must match the following formal declaration:

OSErr MyJobStatus (gxStatusRecord *aStatusRecord);

aStatusRecord

A pointer to a status structure.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXJobStatus message when a printing extension or printer driver calls the GXReportStatus function.

An example of why you might override this message is to display the status in a window.

The default implementation of this message displays the status in the desktop printer window.

SPECIAL CONSIDERATIONS

You never send the GXJobStatus message yourself.

You must forward the GXJobStatus message to other message handlers.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The status structure is described in the section "The Status Structure" beginning on page 4-39.

The GXReportStatus function is described on page 5-17 in the chapter "Printing Functions for Message Overrides."

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help